home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / am120.zip / AM120.DOC next >
Text File  |  1991-02-15  |  78KB  |  1,774 lines

  1.  
  2.  
  3.  
  4.                                REGISTRATION FORM
  5.      
  6.      
  7.      Mail To: Hedish and Associates
  8.               21324 Alder Drive, Suite 102
  9.               Santa Clarita, CA  91321
  10.               USA
  11.      
  12.      
  13.      
  14.      Name:________________________________________________________________
  15.      
  16.      
  17.      Address:_____________________________________________________________
  18.      
  19.      
  20.              _____________________________________________________________
  21.      
  22.      
  23.      Telephone:___________________________________________________________
  24.      
  25.      
  26.      
  27.      [ ] AutoMate Registration....................................$   20.00
  28.      
  29.          Includes AutoMate registration, diskette, & Vox2Host 
  30.      
  31.      
  32.      [ ] Overseas Shipping........................................$    3.00
  33.      
  34.      
  35.      
  36.                                                   Total:          $________
  37.      
  38.      Payment Method: [ ] Check   [ ] Money Order 
  39.                      (Payment must be in US funds)
  40.      
  41.      Diskette Size:  [ ] 3.5" Floppy Diskette   [ ] 5.25" Floppy Diskette
  42.                      There is no additional charge for 3.5" diskettes.
  43.      
  44.      
  45.      I obtained AutoMate from:
  46.      
  47.      [ ] A friend                  [ ] BBS _____________________
  48.                                    
  49.      [ ] Computer Club             [ ] Third Party Vendor
  50.                                    
  51.      [ ] User's Group              [ ] Other ___________________
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.      
  59.      
  60.      
  61.      
  62.      
  63.      
  64.      
  65.      
  66.      
  67.      
  68.      
  69.      
  70.      
  71.      
  72.                                A u t o M a t eTM
  73.      
  74.      
  75.                          Automated Communication Script
  76.      
  77.                                   Version 1.2
  78.      
  79.      
  80.      
  81.      
  82.      
  83.      
  84.      
  85.      
  86.      
  87.      
  88.      
  89.      
  90.      
  91.      
  92.      
  93.      
  94.      
  95.      
  96.      
  97.      
  98.      
  99.      
  100.      
  101.      
  102.      
  103.      
  104.                        (C) Copyright 1991 Marc S. Hedish
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.        
  112.      
  113.      
  114.      
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.                                TABLE OF CONTENTS
  122.      
  123.      Introduction.......................................................  1
  124.      
  125.      What You Need......................................................  2
  126.      
  127.      Registering AutoMate...............................................  3
  128.      
  129.      Disclaimer.........................................................  4
  130.      
  131.      Installation.......................................................  5
  132.      
  133.      Commands..........................................................  11
  134.          BeginRecording................................................  11
  135.          ChangePassword................................................  11
  136.          DeleteMail..................................................... 12
  137.          DeleteRecording................................................ 12
  138.          DeleteReplies.................................................. 12
  139.          EndRecording................................................... 12
  140.          ExchangeMail................................................... 13
  141.          GetBulletins................................................... 13
  142.          GetFiles....................................................... 14
  143.          GetMail........................................................ 15
  144.          JoinConference................................................. 15
  145.          LogOff......................................................... 16
  146.          LogOn.......................................................... 16
  147.          Quit........................................................... 16
  148.          SendFiles...................................................... 17
  149.          SendReplies.................................................... 18
  150.          SetDLPath...................................................... 18
  151.          SetMailDoor.................................................... 19
  152.          SetType........................................................ 19
  153.          SetULPath...................................................... 20
  154.          Term........................................................... 20
  155.      
  156.      Operation.......................................................... 21
  157.       
  158.      AMDial............................................................. 23
  159.       
  160.      Common Problems.................................................... 29
  161.      
  162.      How To Obtain Help................................................. 30
  163.      
  164.      Credits............................................................ 31
  165.      
  166.      Sample Note Files.................................................. 32
  167.      
  168.      Index.............................................................. 35
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.      
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.                                   INTRODUCTION
  183.      
  184.      
  185.      AutoMate was originally designed to be used with The Forbin  Project's  
  186.      communication  package, Qmodem, to allow Qmodem to call a PCBoard  and 
  187.      automatically log on, send and receive MarkMail, DjMail, KMail, Qmail, 
  188.      & MegaMail mail packets, send and receive files, and log off.  
  189.      
  190.      Beginning with version 1.2 AutoMate supports GAP and Spitfire bulletin 
  191.      boards  as  well.  Version 1.2 will also work with  Qmodem's  built-in 
  192.      Host  Mode.   We've also added MarkMail 2.0, SFMail and  The  Complete 
  193.      Mail Door to the list of supported mail doors.  In addition,  AutoMate 
  194.      will  now  work  with PCBoards in which the  Sysop  has  modified  the 
  195.      command prompts to include the user name.
  196.      
  197.      AutoMate has been tested with Qmodem 4.0 - 4.2F, PCBoard 12.X -  14.5, 
  198.      GAP  5.0, Spitfire 3.0, MarkMail, DjMail, KMail, Qmail, and  MegaMail, 
  199.      SFMail, The Complete Mail Door.
  200.      
  201.      By  using  AutoMate's  companion, AMDial, you  can  set  up  automated 
  202.      sessions  to run at a specific time of the day.  This  feature  should 
  203.      save  tremendously on your telephone bill since, for example, you  can 
  204.      now  download that 500K+ file at 4:00 a.m. when the rates  are  lower.    
  205.      In effect, AutoMate allows you the freedom of "Auto BBSing".
  206.      
  207.      It also saves time since you don't have to babysit the session issuing 
  208.      commands as you go along.  Your entire session can be carried out  for 
  209.      you while you are fast asleep.
  210.      
  211.      AutoMate  is  unique in that the commands which it  will  execute  are 
  212.      stored in Qmodem's attached note files.  This allows you to store  and 
  213.      use a different set of commands and parameters for each of the entries 
  214.      in  your dialing directory.  This also makes it possible to  have  one 
  215.      script  which  will work on as many different boards as  you  wish  to 
  216.      call.
  217.      
  218.      The command file (Qmodem Attached Note File) can be edited on the  fly 
  219.      while in Qmodem by using the built-in Full Screen Editor (@FSE) or any 
  220.      other text editor (QEdit, TED, etc.) without leaving Qmodem.
  221.      
  222.      AutoMate's companion dialer, AMDial, can also limit the number of busy 
  223.      re-tries and set an beginning and ending dialing time.  This should be 
  224.      of  particular importance to SysOps and long distance  callers.   Long 
  225.      distance  callers  can  now  tell  AutoMate  to  begin  dialing  after 
  226.      11:00 p.m.  and stop calling at 6:00 a.m. to obtain the best  possible 
  227.      phone  rates.  SysOps can use the end time to insure  their  EVENT.SYS 
  228.      will be concluded by a particular time rather than be left in Qmodem's 
  229.      dialing queue until a connection is made.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                  WHAT YOU NEED
  237.      
  238.      
  239.      Qmodem!   AutoMate was designed to work with Qmodem versions  4.0  and 
  240.      above.  Any version you currently have installed should work correctly 
  241.      with AutoMate and AMDial as long as it is in the 4.XX series.
  242.      
  243.      All hardware requirements are that of Qmodem.
  244.      
  245.      AutoMate  requires  approximately  28K of disk space  in  your  Qmodem 
  246.      Scripts directory.  In addition to this the command files you will  be 
  247.      using require less than 2K of disk space each.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.                               REGISTERING AUTOMATE
  255.      
  256.      
  257.      AutoMate  is fully functional Shareware.  You may try it, use it,  and 
  258.      share  it  with others (in its original unmodified form).  It  is  not 
  259.      free  software  nor public domain software.  If you use  AutoMate  for 
  260.      more  than  30  days  you are required to pay  for  and  register  the 
  261.      program.
  262.      
  263.      Your registration will provide you with the following...
  264.      
  265.      The latest version of AutoMate with complete documentation.
  266.      
  267.      The  author's  voice support telephone number.  Registered  users  may 
  268.      contact the author directly with any questions about AutoMate.
  269.      
  270.      A  registered  copy  of  another add-in  for  Qmodem  by  the  author, 
  271.      VOX2HOST.
  272.      
  273.      VOX2HOST lets you share your data and voice lines.  Your computer  can 
  274.      always be ready to enter a host mode and it shares that line with your 
  275.      voice  line.  Call, let it ring once, hang up and call back within  90 
  276.      seconds  and you are placed in Qmodem's Host mode.  If a normal  voice 
  277.      call comes in it does not affect the host.  It can also page you  when 
  278.      a  voice  call is received.   VOX2HOST also keeps a log of  the  calls 
  279.      received.  It is also useful to share your data line with a FAX  line.  
  280.      Normal  FAX  messages are answered uninterrupted by the  fax  machine, 
  281.      with  the  added  capability of paging you; also  data  calls  can  be 
  282.      answered by the host.
  283.      
  284.      Your  registration also guarantees future development of  AutoMate  as 
  285.      well as other products.  As new mail doors and bulletin board  formats 
  286.      emerge,  AutoMate  will be updated to work with these... but  only  if 
  287.      there is support from its users.
  288.      
  289.      To  register  AutoMate and receive the above, send a $20.00  check  or 
  290.      money order (U.S. Funds) to...
  291.      
  292.                                   Marc Hedish
  293.                            c/o Hedish and Associates
  294.                           21324 Alder Drive, Suite 102
  295.                          Santa Clarita, CA  91321-4240
  296.      
  297.      Please  specify  disk size.  There is no additional  charge  for  3.5" 
  298.      disks.   Allow  3-4 weeks for delivery.  Multiple copy  discounts  for 
  299.      SysOps, user groups and clubs are available.
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                    DISCLAIMER
  307.      
  308.      
  309.      The  author makes no warranty of any kind, either express or  implied, 
  310.      including but not limited to any warranties or merchantability  and/or 
  311.      fitness for a particular purpose with respect to this software  and/or 
  312.      accompanying  documentation.  The author shall not be liable  for  any 
  313.      damages,  whether direct, indirect, special or  consequential  arising 
  314.      from the use of this product.
  315.      
  316.      IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DAMAGES, INCLUDING  ANY 
  317.      LOST PROFITS, LOST SAVINGS, BUSINESS INTERRUPTION, LOSS OF INFORMATION 
  318.      OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR 
  319.      INABILITY TO USE THIS PROGRAM.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                   INSTALLATION
  327.      
  328.      
  329.      To use AutoMate, simply place it in your Qmodem scripts directory  and 
  330.      attach  the script to the PCBoards in your dialing  directory  through 
  331.      the [R]evise command.  If you are unsure of how to attach AutoMate  to 
  332.      the  entries in your dialing directory consult the Qmodem  manual  for 
  333.      more information.
  334.      
  335.                   +============= Revise Entry ==============+
  336.                   | Name        Absolut(e)ly Temporary      |
  337.                   | Number      1-702-254-8601              |
  338.                   | Password    PASSWORD                    |
  339.                   | Script      AUTOMATE                    |
  340.                   | Baud Rate   19200                       |
  341.                   | Data Bits   8                           |
  342.                   | Parity      N                           |
  343.                   | Stop Bits   1                           |
  344.                   | Duplex      F                           |
  345.                   | Protocol    G                           |
  346.                   | Last Call   02/14/91                    |
  347.                   | Times On    853                         |
  348.                   +================================F1 Help==+
  349.      
  350.      
  351.      It is recommended that you set Qmodem's Auto-Increment function to  ON 
  352.      via Qinstall's Alt-N/P/T/A and the Overwrite files function set to OFF 
  353.      via  Qinstall's  Alt-N/P/T/O.  This combination has been found  to  be 
  354.      best.   If  a file already exists and AutoMate tries to  download  the 
  355.      same  file (this applies to .QWK files too) it will leave the old  one 
  356.      intact  and  Qmodem  will  automatically save the  new  one  under  an 
  357.      incremented name.  You can then decide later which one(s) to keep,  it 
  358.      is entirely up to you.
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.      
  366.      
  367.      
  368.      The  second  step is to add AutoMate commands to  your  attached  note 
  369.      files.  Don't worry about losing any of the important information  you 
  370.      have  stored there.  AutoMate will not affect your current use of  the 
  371.      note  files.   You  may continue to store  any  other  information  in 
  372.      addition to the AutoMate commands.
  373.      
  374.      To  do this, call up the dialing directory [ALT]+[D] and press [N]  to 
  375.      update  a Note.  Whether or not you are storing any other  information 
  376.      in  the  note  file is irrelevant.  AutoMate will look  for  it's  own 
  377.      keyword  and  ignore  the  rest of the  note  file.   All  text  above 
  378.      AutoMate's  name  is ignored.  The following is a  sample  note  files 
  379.      which you can use as a starting point.  
  380.      
  381.      
  382.      +========================= Full Screen Edit =========================+
  383.      |      Line 15   Col 1   Insert Indent     C:SAMPLE                  |
  384.      |Sample Note File for use with AutoMate                              |
  385.      |                                                                    |
  386.      |Board: Absolut(e)ly Temporary                                       |
  387.      |Sysop: Charles Shapiro                                              |
  388.      |Modem: Courier HST                                                  |
  389.      |                                                                    |
  390.      |The home of AutoMate!                                               |
  391.      |                                                                    |
  392.      |AutoMate                                                            |
  393.      |Marc Hedish                                                         |
  394.      |AT-MM.QWK                                                           |
  395.      |AT-MM.REP                                                           |
  396.      |9                                                                   |
  397.      |F                                                                   |
  398.      |                                                                    |
  399.      |                                                                    |
  400.      |                                                                    |
  401.      |                                                                    |
  402.      |                                                                    |
  403.      |                                                                    |
  404.      |                                                                    |
  405.      +====================================================================+
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.      
  413.      
  414.      
  415.      The  sample  shows  the use of the AutoMate key  word.    It  must  be 
  416.      spelled correctly.  AutoMate will search for it's name.  If it is  not 
  417.      found  you  will be given an error message stating that there  are  no 
  418.      commands in the note file.  (See page 33, example 4)
  419.      
  420.      The next line is the name you use on this particular board.  This  way 
  421.      you can be "JOHN DOE" on one board and "JOHNNY DOE" on another without 
  422.      having  to change the script.  For SysOps this will allow you to  call 
  423.      the  same board both as yourself and also under your board's name  for 
  424.      network mail runs.
  425.      
  426.      The next two lines are the name of the .QWK and .REP files used in the 
  427.      mail  doors.  This is different for each board.  In the case of  QMail 
  428.      these are the .DL and .UL files respectively and for SFMail these  are 
  429.      the SFMAIL.ZIP and SFMAIL.REP files.
  430.      
  431.      The next line is the door number for the mail door.  Do not place  the 
  432.      words  "OPEN" or "DOOR" here.  All that is needed is the door  number. 
  433.      For  Spitfire  boards  this would be the command letter  used  in  the 
  434.      message menu to open SFMail (usually M or S).
  435.      
  436.      The next line is the protocol used in the mail door.  Since most  mail 
  437.      doors  do not support batch protocols you can specify a protocol  here 
  438.      which  is  different from the one you use to send and  receive  files.  
  439.      This may or may not be the same as your default protocol.  It is  only 
  440.      here so you have the option of using two different protocols, one  for 
  441.      mail  transfers  and  one  for file  transfer.   Again,  this  may  be 
  442.      different  for  each board.  In the case of Qmail 4.0,  this  protocol 
  443.      will be used regardless of which is set as your default in Qmail.
  444.      
  445.      If you have not chosen a default protocol for MarkMail 2.0 and SFMail, 
  446.      AutoMate  will use whatever protocol you designate here.  If  you  are 
  447.      using  anything other than Qmail and wish to use /G  protocols  choose 
  448.      "F"  (1K-Xmodem/G) rather than "G" (Ymodem/G).  Inside the mail  doors 
  449.      these  are  functionally  identical  since  only  one  file  is  being 
  450.      transferred  rather  than  a batch of files.   Using  "G"  will  cause 
  451.      AutoMate to not work properly due to the way in which the commands are 
  452.      passed to the mail doors.  
  453.      
  454.      The first six lines give AutoMate all the information it needs to work 
  455.      with the board you are calling.  They must be placed in the note  file 
  456.      and  must  be in the prescribed order.  No AutoMate  commands  may  be 
  457.      placed above the protocol line.
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.      
  465.      
  466.      
  467.      Once these lines are written into the note file all that is  necessary 
  468.      to  change what AutoMate will do is to change the lines  which  follow 
  469.      the protocol line.
  470.      
  471.      Starting with this version AutoMate allows you to "comment out" any of 
  472.      the commands contained in the note file.  You may also add comments in 
  473.      the  note  files which will be ignored.  To comment out  a  particular 
  474.      command  simply  add any character (e.g. a period,  asterisk,  letter, 
  475.      etc.) followed by a space before the command.  This will tell AutoMate 
  476.      to ignore the line.
  477.      
  478.      You may, if you wish, add any notes in the middle of the command  list 
  479.      as  long  as  the line contains at least  one  space  betweens  words.  
  480.      AutoMate 1.2 will treat this too as a comment line.  
  481.      
  482.      If you are going to comment out a command which has parameters on  the 
  483.      following lines (e.g. SendFiles, JoinConference) you must comment  out 
  484.      the parameter line as well or AutoMate will attempt to execute this as 
  485.      a command and will hang.
  486.      
  487.      +========================= Full Screen Edit =========================+
  488.      |      Line 15   Col 1   Insert Indent     C:SAMPLE                  |
  489.      |                                                                    |
  490.      |Board: Absolut(e)ly Temporary                                       |
  491.      |Sysop: Charles Shapiro                                              |
  492.      |Modem: Courier HST                                                  |
  493.      |                                                                    |
  494.      |AutoMate                                                            |
  495.      |Marc Hedish                                                         |
  496.      |AT-MM.QWK                                                           |
  497.      |AT-MM.REP                                                           |
  498.      |9                                                                   |
  499.      |F                                                                   |
  500.      |SetType *           <--<< Command followed by a space and asterisk  |
  501.      |* DeleteRecording   <--<< Asterisk followed by space                |
  502.      |BeginRecording                                                      |
  503.      |LogOn                                                               |
  504.      |Walk the dog        <--<< Words seperated by spaces                 |
  505.      |/ DeleteMail        <--<< Slash followed by space                   |
  506.      |ExchangeMail                                                        |
  507.      |End World Hunger.   <--<< Words seperated by spaces                 |
  508.      |LogOff                                                              |
  509.      |DeleteReplies                                                       |
  510.      +====================================================================+
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.      
  518.      
  519.      
  520.      Now  is  when  the fun begins!
  521.      
  522.      The following are the commands for AutoMate.  They may be used in  any 
  523.      order, but some common sense must be used.  It would not make a lot of 
  524.      sense  to DeleteMail just after the GetMail command!  For example,  it 
  525.      is up to you whether you want to send your replies before you get  the 
  526.      new mail or not.
  527.      
  528.      
  529.      
  530.             BeginRecording ChangePassword DeleteMail DeleteRecording 
  531.      
  532.               DeleteReplies EndRecording ExchangeMail GetBulletins 
  533.      
  534.           GetFiles GetMail JoinConference LogOn LogOff Quit SendFiles 
  535.      
  536.            SendReplies SetDLPath SetMailDoor SetType SetULPath Term 
  537.      
  538.      
  539.      
  540.      
  541.      The commands are case-insensitive but placed in mixed case (as  above) 
  542.      makes it easier to read.  They must, however, be spelled as above.
  543.      
  544.      Each command must be placed on a separate line by itself.  (See below)
  545.      
  546.      Usually,  the first thing to do is LogOn.  This command uses the  name 
  547.      you  have  stored  in the note file and the  password  stored  in  the 
  548.      dialing  directory.   Be sure to have the correct password  stored  in 
  549.      your  dialing  directory.  If you wish to have the  session  conducted 
  550.      with ANSI graphics use LogOnG rather then LogOn.  
  551.      
  552.      You  may wish to use the BeginRecording command before logging  on  so 
  553.      that  this  too is recorded to the .CAP file.  You  may  use  AutoMate 
  554.      starting with any of the commands.
  555.      
  556.      AutoMate  can  be  used  for  transfers once  you  are  already  on  a 
  557.      particular  BBS.  Since AutoMate 1.2 now works with a variety  of  BBS 
  558.      software  you  must use the SetType command so that AutoMate  will  be 
  559.      able  to  determine which type of BBS it is speaking  with.   Use  the 
  560.      SetType  command in place of the LogOn (LogOnG) command in  your  note 
  561.      file.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.      
  569.      
  570.      
  571.      Once  you have completed your transfers, you have some  options.   You 
  572.      can  use LogOff to log yourself off the board.  If you are in  a  mail 
  573.      door,  AutoMate  will now logoff inside of the mail door  rather  than 
  574.      return  to  the BBS first.  This will shorten the length of  calls  on 
  575.      boards  which load their mail doors through DDoor.  The  Term  command 
  576.      will  stop  the script and leave you in Qmodem's terminal  mode  while 
  577.      still  logged on the BBS.  This allows you to work interactively  with 
  578.      PCBoard without having to make an additional call.  
  579.      
  580.      The  Quit command will cause AutoMate to leave Qmodem  altogether  and 
  581.      return  you  to DOS.  (Be sure to LogOff before using Quit  or  Qmodem 
  582.      will  just  hang up on the BBS.  This is not considered  a  very  nice 
  583.      thing to do.)
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                           
  591.                                     COMMANDS
  592.      
  593.      
  594.      BeginRecording -    This command allows you to capture the session  to 
  595.                          AutoMate's   capture  file.   It  will  be   named 
  596.                          AUTOMATE.CAP and will be in your script directory.  
  597.      
  598.                          This  is useful for middle of the night mail  runs 
  599.                          if  you wish to double-check the session.   It  is 
  600.                          not always necessary, since your session log  will 
  601.                          show  the successful file uploads  and  downloads.  
  602.                          (If  you are experiencing troubles  with  AutoMate 
  603.                          please use this command to capture the session  in 
  604.                          question   before  you  contact  us   for   help.)
  605.      
  606.      
  607.      ChangePassword -    This  command allows you to change  your  password 
  608.                          for  a particular board anytime you wish.   It  is 
  609.                          not available on Qmodem Host Mode systems.
  610.      
  611.                          Place  this command on a single line, followed  by 
  612.                          the new password you wish on the following line.
  613.      
  614.                          On  PCBoard and GAP systems the new password  will 
  615.                          not be visible during the session.  AutoMate  will 
  616.                          verify  that the new password was indeed  received 
  617.                          correctly  before moving on to the  next  command.  
  618.                          If  it  was not, the session log will  be  stamped 
  619.                          stating the password was not changed.
  620.      
  621.                          The password will be visible on Spitfire  systems.  
  622.                          This is a deficiency in Spitfire.  Caution must be 
  623.                          exercised when using this command on Spitfire.  Be 
  624.                          sure  no  one  around to  view  the  monitor  when 
  625.                          executing this command.
  626.      
  627.                          If the password was accepted, the session log will 
  628.                          simply  note that the password has  been  changed.  
  629.                          After a session in which you change your password, 
  630.                          don't  forget  to  change  the  password  in  your 
  631.                          Dialing Directory as well.  If you fail to  change 
  632.                          the  password in the dialing  directory,  AutoMate 
  633.                          will not be able to connect the next time.
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.      
  641.      
  642.      
  643.      DeleteMail -        Automatically  deletes,  if it  exists,  the  .QWK 
  644.                          (.DL, .ZIP) mail packet of the current connection.  
  645.                          AutoMate   will  look  in  your  Qmodem   download 
  646.                          directory for the mail packet named in the command 
  647.                          file.  Use this command before the GetMail command 
  648.                          to  delete the old mail packet before  downloading 
  649.                          the new one.  This is not necessary if you want to 
  650.                          have  Qmodem  save  the new  file  via  its  auto-
  651.                          increment function.  Some readers - such as SLMR - 
  652.                          allow  you  to delete the .QWK file  after  having 
  653.                          read it.  For those readers which don't, this will 
  654.                          help  in  keeping your mail straight as  only  the 
  655.                          current mail packet will remain on your disk.   If 
  656.                          the deletion is unsuccessful the session log  will 
  657.                          be  stamped accordingly.  If the .QWK file is  not 
  658.                          found, AutoMate will move on to the next command.
  659.      
  660.      
  661.      DeleteRecording -   Automatically deletes the capture file created  by 
  662.                          the  BeginRecording  command.   Use  this  command 
  663.                          before  the BeginRecording command to  ensure  the 
  664.                          capture  file  created  is  for  this   particular 
  665.                          session   only   as  AutoMate   normally   appends 
  666.                          recording sessions.  If unsuccessful, the  session 
  667.                          log  will  note  this.  If the .CAP  file  is  not 
  668.                          found, AutoMate will move on to the next command.
  669.      
  670.      
  671.      DeleteReplies -     Automatically  deletes  the reply packet  for  the 
  672.                          current  connection.  Use this command  after  the 
  673.                          SendReplies  command  to delete the  reply  packet 
  674.                          from your disk.  If the deletion is  unsuccessful, 
  675.                          the session log will note this.  If the .REP  file 
  676.                          is  not found, AutoMate will move on to  the  next 
  677.                          command.
  678.      
  679.      
  680.      EndRecording -      This  will  end the session  recording  which  was 
  681.                          started  by  the  BeginRecording  command.    Both 
  682.                          BeginRecording  and  EndRecording  may  be  placed 
  683.                          anywhere in the command file, and may be used more 
  684.                          than  once.   If there is just one part  which  is 
  685.                          important   to   check,   you   can   place    the 
  686.                          BeginRecording  and EndRecording  commands  around 
  687.                          that command only.
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.      
  695.      
  696.      
  697.      ExchangeMail -      Opens the mail door and sends the reply packet  if 
  698.                          it  exists.   After  sending  the  reply   packet, 
  699.                          ExchangeMail will retrieve the mail packet.   This 
  700.                          command  is  similar  to  issuing  a   SendReplies 
  701.                          command  followed  by a GetMail command  with  the 
  702.                          following  exception:  ExchangeMail will not  exit 
  703.                          the mail door and re-enter it.
  704.      
  705.                          If  you  are  using  MegaMail  you  must  use  the 
  706.                          ExchangeMail     command    rather    than     the 
  707.                          SendReplies/GetMail  combination.  This is due  to 
  708.                          the way MegaMail works.  It requires an upload  of 
  709.                          the  reply packet before it will download any  new 
  710.                          messages.
  711.      
  712.                          This  command  is  not available  on  Qmodem  Host 
  713.                          boards.
  714.      
  715.      
  716.      GetBulletins -      This is only available on PCBoard systems.
  717.      
  718.                          Retrieves  from  PCBoard the  bulletins  following 
  719.                          this  command in the note file.  Place the  number 
  720.                          of the bulletin(s) you wish on the line  following 
  721.                          this  command.  If you wish to retrieve more  than 
  722.                          one   bulletin  place  the  additional   bulletins 
  723.                          number(s)  on  the same line.  You  may  also  use 
  724.                          PCBoard's   "A"  command  to  retrieve   All   the 
  725.                          bulletins.    AutoMate  will  use   the   protocol 
  726.                          specified   in  the  dialing  directory  for   the 
  727.                          connected board.
  728.      
  729.                          This  command is helpful in  retrieving  bulletins 
  730.                          which  are not updated frequently if at all.   The 
  731.                          mail  doors will retrieve new bulletins where  this 
  732.                          command  allows you to retrieve any  bulletin  you 
  733.                          wish.
  734.      
  735.                          If  you choose to download more than one  bulletin 
  736.                          at  a time or use the "A" command you must  use  a 
  737.                          batch protocol.  If the download requires a  batch 
  738.                          protocol  and  you  have  not  specified  a  batch 
  739.                          protocol in the dialing directory the command will 
  740.                          be  aborted  and an appropriate  message  will  be 
  741.                          stamped in the session log.
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.      
  749.      
  750.      
  751.      GetFiles -          Retrieves  from the current connection  the  files 
  752.                          following  this  command in the note  file.   Each 
  753.                          filename  must be listed on consecutive lines  and 
  754.                          the  file list must terminate by placing a  single 
  755.                          asterisk (*) on the line after the last  filename.  
  756.                          AutoMate  will use the default protocol stored  in 
  757.                          Qmodem's dialing directory.
  758.      
  759.                          You  can use globals in the filenames if you  wish 
  760.                          but  you must be careful.  You may get more  files 
  761.                          than  you bargained for!  For example, it  is  not 
  762.                          recommend  to  use GetFiles  followed  by  A*.ZIP!  
  763.                          
  764.                          Your  transfer protocol should also support  batch 
  765.                          file  transfers if you are going to  use  globals.  
  766.                          AutoMate  will  make  up  to  three  attempts   to 
  767.                          download each file.  If it is still  unsuccessful, 
  768.                          AutoMate  will abort that file and move on to  the 
  769.                          next  file or command.  Any failure will be  noted 
  770.                          in your session log.
  771.      
  772.                          If  downloads  have been disabled for  any  reason 
  773.                          (e.g. an impending event) AutoMate will abort  the 
  774.                          attempt  and  move on to the next command  in  the 
  775.                          command file.
  776.      
  777.      
  778.                          On  PCBoard  systems if the  particular  file  you 
  779.                          request  is  password protected simply  place  the 
  780.                          password on the line following the filename.  When 
  781.                          prompted,  AutoMate will send this in response  to 
  782.                          the password request.
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.      
  790.      
  791.      
  792.      GetMail -           Opens the mail door and retrieves the mail  packet 
  793.                          automatically.  AutoMate normally stores the  mail 
  794.                          packet  in your Qmodem download directory.   Three 
  795.                          separate  attempts  will be made to  download  the 
  796.                          mail packet, after which AutoMate will stamp  your 
  797.                          session log with a note telling of the failure and 
  798.                          will  then move on to the next command.  If  there 
  799.                          are no new messages for you, AutoMate will move on 
  800.                          to the next command.
  801.      
  802.                          AutoMate  will automatically detect which  of  the 
  803.                          seven supported mail doors it is working with  and 
  804.                          adjust  accordingly.  The only exception  to  this 
  805.                          rule  is Qmail.  In order for AutoMate  to  detect 
  806.                          the  Qmail door you must configure the Qmail  door 
  807.                          for "extended prompts".  (See chapter 3, page 5  of 
  808.                          the Qmail 4.0 manual for more information.)
  809.      
  810.                          This  command  does  not  apply  to  Qmodem   Host 
  811.                          systems.
  812.      
  813.      
  814.      JoinConference -    This is available on PCBoard and GAP systems only.
  815.      
  816.                          This  command  will let you selectively  join  and 
  817.                          abandon  conferences.  Since some boards have  the 
  818.                          mail    doors    accessible   only   in    certain 
  819.                          conferences,  AutoMate has the ability to  select, 
  820.                          by number, the conference you are in at any time.
  821.      
  822.                          Place  this command on a single line, followed  by 
  823.                          the  conference  number you wish to  join  on  the 
  824.                          following line.
  825.      
  826.                          JoinConference
  827.                          11
  828.                          GetMail
  829.                          JoinConference
  830.                          0
  831.      
  832.                          JoinConference is also helpful in sending  uploads 
  833.                          to a specific conference.  By using JoinConference 
  834.                          before  the SendFiles command you can  be  assured 
  835.                          the file you are sending will be posted within the 
  836.                          correct conference.
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.      
  844.      
  845.      
  846.      LogOff -            Logs  off the current connection  using  [G]oodbye 
  847.                          command.   AutoMate  will then wait  for  the  "NO 
  848.                          CARRIER"   response   from   your   modem   before 
  849.                          continuing.   This is to make sure you are  indeed 
  850.                          logged   off  correctly.   If  after  10   seconds 
  851.                          AutoMate   does  not  receive  the  "NO   CARRIER" 
  852.                          response it will send a hang up command.  This was 
  853.                          added  in beta testing to work with such  networks 
  854.                          as StarLink.
  855.      
  856.      
  857.      LogOn -             Logs  on, in Non-Graphic mode, to the  board  with 
  858.                          which  Qmodem  just connected.   LogOn   uses  the 
  859.                          password from the dialing directory.  If you  wish 
  860.                          to  have the session conducted with ANSI  graphics 
  861.                          on  simply append a "G" to the LogOn command.   In 
  862.                          other  words  LogOn will select  Non-Graphics  and 
  863.                          LogOnG will select Graphic mode.  
  864.      
  865.                          On PCBoards, it also issues a "CHAT U" command  so 
  866.                          that  no  one will try and chat with a  script  on 
  867.                          multi-node boards.
  868.      
  869.      
  870.                          If  you  are calling a Qmodem Host  system  it  is 
  871.                          recommended  that  the host be setup as  a  closed 
  872.                          rather than open system.  If it is an open system,  
  873.                          AutoMate  will log you in as a new user under  the 
  874.                          name of N Q with a password of NS.  This is due to 
  875.                          the automatic board determintation.  AutoMate will 
  876.                          function normally if the host has been set up as a 
  877.                          closed board.
  878.      
  879.      Quit -              This command will exit AutoMate and QModem return-
  880.                          ing you to the DOS prompt.  Don't forget to LogOff 
  881.                          first or you may upset your favorite SysOp!
  882.      
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.      
  890.      
  891.      
  892.      SendFiles -         Uploads   the  listed  files  to  the   connection 
  893.                          automatically.    Each  filename  must  be  on   a 
  894.                          separate line.  For PCBoard and Spitfire the  line 
  895.                          after the filename will be sent as the description 
  896.                          of  the file.  For GAP boards the line  after  the 
  897.                          filename  is  used to designate whether  the  file 
  898.                          will be public or private.  This should be  either 
  899.                          an "N" (Public) or "Y" (private) and will be  sent 
  900.                          in response to the board's prompt.  Following that 
  901.                          line  the  next  will  be  sent  as  the  list  of 
  902.                          keywords.   The line after these keywords will  be 
  903.                          sent as the file description.  Qmodem Host  boards 
  904.                          do  not accept a file description.  As such,  just 
  905.                          place  the  filenames  in  the  list  without  any 
  906.                          description lines.
  907.      
  908.                          For PCBoard and GAP boards, you can send  multiple 
  909.                          line descriptions my placing the ^M combination in 
  910.                          the middle of the line as follows...
  911.      
  912.                          SendFiles
  913.                          SAMPLE.ZIP
  914.                          This is a sample of a long file^Mdescription. Wow!
  915.                          *
  916.      
  917.                          You can send multi line descriptions by using  the 
  918.                          method  listed above.  Be aware that  some  SysOps 
  919.                          limit the number of lines in a description.
  920.      
  921.                          If uploads have been disabled for any reason (e.g. 
  922.                          an  impending event, no upload space  left,  etc.) 
  923.                          AutoMate will not attempt the upload and will move 
  924.                          on to the next command in the command file.
  925.      
  926.                          AutoMate will check for notification that the file 
  927.                          is  already  posted on the board.  If  it  is  not 
  928.                          posted  three  attempts will be made to  post  the 
  929.                          file  before AutoMate stamps your session log  and 
  930.                          moves on to the next file.  When there are no more 
  931.                          files to upload, AutoMate will move on to the next 
  932.                          command.
  933.      
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.      
  941.      
  942.      
  943.      SendReplies -       Opens  the mail door and sends reply  packet  from 
  944.                          Qmodem's   upload  directory  or   the   directory 
  945.                          specified  by the SetULPath command.  As with  the 
  946.                          GetMail command, Automate will make three separate 
  947.                          attempts to upload the mail packet.  If the upload 
  948.                          is unsuccessful, AutoMate will stamp your  session 
  949.                          log with a note telling you of the failure and will 
  950.                          then  move  on to the next command.  If  the  .REP 
  951.                          file  is not found, AutoMate will move on  to  the 
  952.                          next command.
  953.      
  954.                          This command does not apply to Qmodem Host boards.
  955.      
  956.      
  957.      SetDLPath -         This command is new to version 1.2.  It overrides 
  958.                          the  default download path for both file and  mail 
  959.                          transfers.   This  is  particularly  helpful   for 
  960.                          SFMail  transfers  so  the  SFMAIL.ZIP  file   can 
  961.                          automatically  be placed in the same directory  as 
  962.                          the reader.  
  963.      
  964.                          It's  also helpful for anyone who wishes  to  keep 
  965.                          their  mail packets in separate  directories  from 
  966.                          their .ZIP files.  
  967.      
  968.                          To  use  SetDLPath, just place this command  on  a 
  969.                          line  and place the fully qualified DOS  path  you 
  970.                          wish  to use on the following line.  You must  end 
  971.                          this path with the ending backslash (\).  AutoMate 
  972.                          will then use this path for all file downloads  in 
  973.                          place of the default.  You may use this command as 
  974.                          often as you wish.  
  975.      
  976.                          The selected path must not be empty.  In order for 
  977.                          AutoMate  to  verify the selected  path  as  being 
  978.                          valid the designated directory must have at  lease 
  979.                          one  file.   This file may be  deleted  after  the 
  980.                          directory is selected.  If the directory is either 
  981.                          empty  or  invalid,  AutoMate  will  use  Qmodem's 
  982.                          default download directory.  The session log  will 
  983.                          be stamped with failure.
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.      
  991.      
  992.      
  993.      SetMailDoor -       Changes   the   door  number  to   be   sent   for 
  994.                          ExchangeMail,  SendReplies, and  GetMail.   Simply 
  995.                          place  this command on a line by itself and  place 
  996.                          the  new  door number (or letter in  the  case  of 
  997.                          Spitfire) on the following line.
  998.      
  999.                          This  will override the door number (letter)  from 
  1000.                          the  note file.  This command was added  to  allow 
  1001.                          network  SysOps  to  download  both  personal  and 
  1002.                          network  mail during the same connect rather  than 
  1003.                          have to hangup and call back.
  1004.      
  1005.                          Used  in combination with the  SetULPath/SetDLPath 
  1006.                          commands you could open one door for personal mail 
  1007.                          and then change the upload and download paths  and 
  1008.                          open a different door for network mail during  the 
  1009.                          same call.
  1010.      
  1011.      
  1012.      SetType -           This  command takes the place of the  LogOn/LogOnG 
  1013.                          command   when  already  connected  to  a   board.  
  1014.                          AutoMate  detects  the board  type  during  LogOn.  
  1015.                          Once already connected you could not use the LogOn 
  1016.                          command.  Simply use this command before any other 
  1017.                          commands  which work with the board  to  determine 
  1018.                          the board type.  Once AutoMate determines this  it 
  1019.                          will be displayed in the Status Window next to the 
  1020.                          words "Current Connection".
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.      
  1028.      
  1029.      
  1030.      SetULPath -         Overrides  the default upload path for  both  file 
  1031.                          and  mail  transfers.  The syntax is that  of  the 
  1032.                          SetDLPath command.
  1033.      
  1034.                          The selected path must not be empty.  In order for 
  1035.                          AutoMate  to  verify the selected  path  as  being 
  1036.                          valid the designated directory must have at  lease 
  1037.                          one  file.   This file may be  deleted  after  the 
  1038.                          directory is selected.  If the directory is either 
  1039.                          empty  or  invalid,  AutoMate  will  use  Qmodem's 
  1040.                          default upload directory.  The session log will be 
  1041.                          stamped with failure.
  1042.      
  1043.                          You  could use this command to upload  files  from 
  1044.                          any  directory rather than have to first move  the 
  1045.                          file into Qmodem's upload directory.
  1046.      
  1047.      Term -              Halts   Automate  and  returns  you  to   Qmodem's 
  1048.                          Terminal Mode.  You can then take control over the 
  1049.                          rest of your session.
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.                                    OPERATION
  1057.      
  1058.      
  1059.      AutoMate's operation is automatic.  As long as you specify AutoMate as 
  1060.      the  attached  script in Qmodem's dialing directory  it  will  execute 
  1061.      automatically once Qmodem connects.
  1062.      
  1063.      AutoMate will ignore all lines in the note file until it sees the word 
  1064.      AutoMate on a single line.
  1065.      
  1066.      This  means  that if you wish to place additional information  in  the 
  1067.      Note  file  you can either place it above all  AutoMate  commands   or 
  1068.      place  all other information below AutoMate and end the AutoMate  com-
  1069.      mands with Quit or Term.
  1070.      
  1071.      You  may end the note file by using the Quit command, Term command  or 
  1072.      by not having any more lines in the note file.
  1073.      
  1074.      AutoMate checks for ONLINE status after the execution of each command.  
  1075.      This  way  it is able to tell if the last operation was  completed  or 
  1076.      aborted due to an offline situation.
  1077.      
  1078.      AutoMate 1.2 will automatically determine which of the four  supported 
  1079.      BBS  types it is communicating with and adjust accordingly.   This  is 
  1080.      detected by the LogOn command.  It is also set by the SetType  command 
  1081.      once online.
  1082.      
  1083.      On PCBoards, AutoMate will automatically determine if it is in ProDoor 
  1084.      and download and upload files correctly.  As you know, ProDoor uses  a 
  1085.      slightly different method for starting a transfer.  AutoMate will also 
  1086.      automatically determine which of the seven supported mail doors it  is 
  1087.      speaking with and will adjust accordingly.  If you are using Qmail, be 
  1088.      sure to configure the door for "extended prompts".
  1089.      
  1090.      Once  AutoMate  takes control it will display a status window  on  the 
  1091.      upper  section of your screen.  This status window shows  which  board 
  1092.      you are connected to, the current command and any error messages.
  1093.      
  1094.      
  1095.       +===================== AutoMate Status Window =====================+
  1096.       | Current Connection - PCBoard       Current Command  Parameter    |
  1097.       | ---------------------------------- ---------------- ------------ |
  1098.       | Absolut(e)ly Temporary             GetFiles         AM120.ZIP    |
  1099.       |     Recording Session to C:\QMODEM\SCRIPTS\AUTOMATE.CAP          |
  1100.       +==================================================== Version 1.2 =+
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.                          MULTI-LANGUAGE CONFIGURATIONS
  1108.      
  1109.      
  1110.      AutoMate can communicate with PCBoards which have been configured  for 
  1111.      multi-language capability.  
  1112.      
  1113.      Many of the better boards use PCB's multi-language capability to allow 
  1114.      the  SysOp  the  freedom  to modify his  command  prompts  etc.  while 
  1115.      maintaining  a  standard set for use by scripts and  session  managers 
  1116.      such as AutoMate.
  1117.      
  1118.      If  the  board  you  are calling has  the  default  language  set  for 
  1119.      "scripts"  or  "default prompts" you need do nothing.   AutoMate  will 
  1120.      handle the "language" prompt automatically.
  1121.      
  1122.      If the SysOp has chosen to have standard PCB prompts as anything other 
  1123.      than the default language you need only add one line to your note file 
  1124.      for that board.
  1125.      
  1126.      Place  the  language  number on the  line  immediately  following  the 
  1127.      transfer protocol to be used in the mail doors.  Do not place anything 
  1128.      other than the number of the language to use on this line.
  1129.      
  1130.      
  1131.      +========================= Full Screen Edit =========================+
  1132.      |      Line 15   Col 1   Insert Indent     C:SAMPLE                  |
  1133.      |Sample Note File for use with AutoMate                              |
  1134.      |                                                                    |
  1135.      |Board: Absolut(e)ly Temporary                                       |
  1136.      |Sysop: Charles Shapiro                                              |
  1137.      |Modem: Courier HST                                                  |
  1138.      |                                                                    |
  1139.      |The home of AutoMate!                                               |
  1140.      |                                                                    |
  1141.      |AutoMate                                                            |
  1142.      |Marc Hedish                                                         |
  1143.      |AT-MM.QWK                                                           |
  1144.      |AT-MM.REP                                                           |
  1145.      |9                                                                   |
  1146.      |F                                                                   |
  1147.      |2 <--<< This tells AutoMate to use Language Number 2 on this board. |
  1148.      |LogOn   This is only necessary of a language other than the default |
  1149.      |        is to be used for this board.                               |
  1150.      |                                                                    |
  1151.      |                                                                    |
  1152.      |                                                                    |
  1153.      |                                                                    |
  1154.      +====================================================================+
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.                                 WHAT IS AMDial?
  1162.      
  1163.      
  1164.      AMDial  stands  for  AutoMate Dialer.  It is  a  companion  script  to 
  1165.      AutoMate  which  allows  you to make unattended mail/file  runs  at  a 
  1166.      specific time of day to one or more boards.
  1167.      
  1168.      AutoMate  will  limit the number of busy redial attempts.   No  longer 
  1169.      will you have Qmodem dialing indefinitely.  An even better feature  is 
  1170.      AMDial's  unique  ability  to limit the dialing period  by  time.   In 
  1171.      addition to specifying a starting time for the dialer you can  specify 
  1172.      an ending time as well!
  1173.      
  1174.      A special feature allows you to automatically call all BBSs which have 
  1175.      reply packets waiting.
  1176.      
  1177.      In  addition, AMDial allows you to start AutoMate from within a  batch 
  1178.      file.
  1179.      
  1180.      AMDial  will  cycle between entries in the dialing queue  rather  than 
  1181.      wait  for each entry in the queue to connect before moving on  to  the 
  1182.      next.
  1183.      
  1184.      To install AMDial, place it in your scripts directory.  You will  also 
  1185.      need to make a minor modification to your Qmodem setup.  It should not 
  1186.      affect normal Qmodem operation.
  1187.      
  1188.      This modification accomplishes two things.  First, it prevents a timed 
  1189.      dialing sequence from being interrupted by an incoming call.   Second, 
  1190.      it  allows  AutoMate  to control the maximum  number  of  busy  redial 
  1191.      attempts as well as control the dialer by time.
  1192.      
  1193.      Simply  change Qmodem's Alt-M/M/R text from the default "RING" to  the 
  1194.      number "7".  Be sure to delete all other text in that entry, including 
  1195.      trailing spaces.  All that should be in that entry is a 7.
  1196.      
  1197.      You must also have the time mask (Alt-N/O/C/T) set to include seconds.  
  1198.      The  recommended  mask  is  hh:mm:ss  however  valid  24  hour  Qmodem 
  1199.      combination (e.g. hh:mm:ss, HH:mm:sste) can be used as long as seconds 
  1200.      are included.
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.                                   USING AMDial
  1208.      
  1209.      
  1210.      AMDial  can be used in a number of different ways.  It can be  started 
  1211.      in any of the following ways...
  1212.      
  1213.      From the Script File Execution [ALT]+[F] command.
  1214.      
  1215.      Press [ALT]+[F] while in Qmodem to bring up the script window.   Enter 
  1216.      the  scripts name (AMDIAL) and press enter.  On the next line is  your 
  1217.      chance to enter the parameters which are passed to AMDial.  
  1218.      
  1219.       +===================== Script File Allocation ======================+
  1220.       |                                                                   |
  1221.       | > C:\QMODEM\SCRIPTS\AMDIAL                                        |
  1222.       |                                                                   |
  1223.       +===================================================================+
  1224.      
  1225.      
  1226.      Enter  the names or part of the names of the boards you wish to  call.  
  1227.      More  than likely you will not be able to enter the complete  name  of 
  1228.      the  board  since  they  are  delimited  by  spaces.   (e.g.  to  call 
  1229.      ABSOLUT(e)LY TEMPORARY  [the  home of AutoMate] you can use  the  word 
  1230.      TEMPORARY  or  perhaps  the "(e)" in ABSOLUT(e)LY but  could  not  use 
  1231.      ABSOLUT(e)LY TEMPORARY as this would tell AMDial that you wish to call 
  1232.      two  boards,  one named ABSOLUT(e)LY, and one named  TEMPORARY.   This 
  1233.      would  cause  AMDial  to make two calls!   AMDial  uses  Qmodem's  `T' 
  1234.      parameter  for designating the boards to call [See your QModem  manual 
  1235.      for more information].
  1236.      
  1237.      A particularly useful feature is the "Replies" command.  By using  the 
  1238.      word,  Replies, as the first entry of your list, AMDial will  look  in 
  1239.      your  upload  directory  for the names of the BBSs  which  have  reply 
  1240.      packets  waiting  to  be sent.  AMDial  will  automatically  load  its 
  1241.      dialing  queue with the names of these boards and then begin  dialing.  
  1242.      By  using  this command you can call up to ten different  boards  and 
  1243.      send  reply packets automatically.  If there are more than ten  reply 
  1244.      packets  waiting, AMDial will call the first ten after which you  can 
  1245.      issue  the  command  once  more  to  dial  the  rest.   Just  use  the 
  1246.      DeleteReplies command in AutoMate to delete the reply packet after  it 
  1247.      was sent.
  1248.      
  1249.      You  can also enter the names of any other boards you wish to call  as 
  1250.      well as the ones who have reply packets waiting by placing them  after 
  1251.      the  Replies command.  As long as there is room in the dialing  queue, 
  1252.      these will also be entered.
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.      
  1260.      
  1261.      
  1262.      If you wish to use the timed dialing features of AMDial simply include 
  1263.      the starting and/or ending times on the same line as the board  names.  
  1264.      If  you  wish  to  have AMDial wait  until  a  specified  time  before 
  1265.      beginning  the dialing place this time (in 24 hour format) before  any 
  1266.      other parameters.
  1267.      
  1268.      If you wish to set an ending time for AMDial place the time (again, in 
  1269.      24 hour format) as the last parameter passed to AMDial.
  1270.      
  1271.      The correct syntax for AMDial is...
  1272.      
  1273.                [START TIME] [REPLIES] Board1 Board2... [END TIME]
  1274.      
  1275.      If  AMDial  does not receive any parameters it will display  an  error 
  1276.      message,  and  wait for you to press any key after which  AMDial  will 
  1277.      return to Qmodem's terminal mode.
  1278.      
  1279.      
  1280.      From a Data File.
  1281.      
  1282.      If  you call the same BBSs all the time and would rather not  have  to 
  1283.      enter  their names each time, you can use your favorite  ASCII  editor 
  1284.      (QEdit,  EDLIN,  Qmodem's @FSE, COPY CON FILENAME, etc.) to  create  a 
  1285.      data file for AMDial to read.  Place the file in the scripts directory 
  1286.      under the name of AMDIAL.DAT.  AMDial will look for this file if there 
  1287.      are  no parameters passed to it.  This .DAT file will be very  similar 
  1288.      to  the parameters you would pass AMDial on the command  line.   Place 
  1289.      the  name of each board to be dialed on a separate line.  If you  want 
  1290.      AMDial to begin at a specified time just place that time as the  first 
  1291.      line.   If it is not present, AMDial will begin immediately.   If  you 
  1292.      wish to force an ending time, place that time as the last line in  the 
  1293.      file.  You can also use the "REPLIES" parameter in the data file.  The 
  1294.      same syntax applies to the data file as to the command line.
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.      
  1302.      
  1303.      
  1304.      From the Command Line.
  1305.      
  1306.      If  you  have set up an AMDIAL.DAT file you can use  Qmodem's  command 
  1307.      line options to begin dialing as follows...
  1308.      
  1309.                            C:\QMODEM>QMODEM /S=AMDIAL
  1310.      
  1311.      This  will load Qmodem and load and execute AMDial automatically.   If 
  1312.      you have placed a start time in the .DAT file, AMDial will wait  until 
  1313.      that  time before beginning to dial.  If not, dialing will begin  once 
  1314.      Qmodem has been loaded.  
  1315.      
  1316.      For  SysOps,  this  is helpful for use in the  EVENT.SYS  of  PCBoard.  
  1317.      AMDial can be set to call up to 10 different boards to exchange E-Mail 
  1318.      packets  by setting up a .DAT file and placing the above command  line 
  1319.      in your EVENT.SYS file.  By using AutoMate along with AMDial not  only 
  1320.      can  you  do your mail runs, but also send and receive  files  without 
  1321.      making additional calls.
  1322.      
  1323.      DO NOT use the "Quit" command in your command file for that call!   If 
  1324.      you  do, AutoMate will exit out of Qmodem and return to DOS  and  will 
  1325.      not  call  any  other boards.  End the command file  with  either  the 
  1326.      "Term" command or no ending command at all.  This will allow  AutoMate 
  1327.      to  return control to AMDial and resume calling all the boards in  the 
  1328.      dialing queue.
  1329.      
  1330.      AMDial's  status  screen shows the name of the board  in  the  dialing 
  1331.      queue,  the  time the dialing attempt started, and the time  which  it 
  1332.      actually  connected.
  1333.      
  1334.      If  there was a problem in executing the AutoMate portion AMDial  will 
  1335.      report  "No Connection" on the status line.  If the AutoMate  run  was 
  1336.      successful, it will show "Completed".  If the AutoMate run was aborted 
  1337.      for  some reason (e.g. loss of carrier) it will show "Error"  and  the 
  1338.      reason for the error.
  1339.      
  1340.      In addition, AutoMate will display the complete name of the board with 
  1341.      which it connected.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.      
  1349.      
  1350.      
  1351.      The following is an example may help in setting up AMDial...
  1352.      
  1353.                03:00:00     -- Wait until 3:00 am to begin dialing
  1354.                Temporary    -- The Home of AutoMate              
  1355.                Poverty      -- Poverty Rock                      
  1356.                Ledge        -- The Home of U'NI-Net              
  1357.                BABBLE                                            
  1358.                05:00:00     -- Stop dialing no later than 5:00 am
  1359.      
  1360.      
  1361.      The  same results can be obtained from the script window  by  entering 
  1362.      the following commands...
  1363.      
  1364.      [ALT]+[F]
  1365.      AMDial [Enter]
  1366.      03:00:00 TEMP POVERTY LEDGE BABBLE 05:00:00 [Enter]
  1367.      
  1368.      
  1369.       +====================== Script File Execution ======================+
  1370.       | Script to execute :                                               |
  1371.       | C:\QMODEM\SCRIPTS\AMDIAL.SCR                                      |
  1372.       | Enter Script Parameters (if any)                                  |
  1373.       | 03:00:00 TEMP POVERTY LEDGE BABBLE 05:00:00                       |
  1374.       +===================================================================+
  1375.      
  1376.      
  1377.      If the "03:00:00" had been left out, AutoMate would call NOW!
  1378.      
  1379.      If  the "05:00:00" had been left off, AutoMate would continue  dialing 
  1380.      until the maximum number of busy-retries was reached for each board.
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.      
  1388.      
  1389.      
  1390.      It is possible to select more than one board at a time because of  the 
  1391.      way in which the dialing command works.  For example...
  1392.      
  1393.      If  "The  Forbin Project" and "The Ledge" were both  in  your  dialing 
  1394.      directory  and  you told AMDial to call "The", both would  be  selected 
  1395.      since  the word "The" is in both entries.
  1396.      
  1397.      At first glance this would seem like a bonus, but it isn't; since  the 
  1398.      dialing  directory would try to call both, it would cycle between  the 
  1399.      two, and once connected, AutoMate would work perfectly, but you  would 
  1400.      have no guarantee as to which one was actually called.  If you entered 
  1401.      "The"  twice,  it is possible that AMDial would call both, but  it  is 
  1402.      also  possible  the  same one would be called  twice.   It  is  always 
  1403.      preferable to use unique parameters for AMDial.  In the above example, 
  1404.      that would be "Forbin" and "Ledge"
  1405.      
  1406.      You  can  also use Qmodem's Fkey to issue an  @SCRIPT AMDIAL,  if  you 
  1407.      wish.  This is particularly useful if you don't change your AMDIAL.DAT 
  1408.      file often.
  1409.      
  1410.      By  using  AMDial along with the "Replies" command, you  have  a  one-
  1411.      button  dialer  which  will automatically look  in  your  upload  file 
  1412.      directory to see which boards have reply packets ready to be sent, and 
  1413.      will then dial those boards.  Just place @SCRIPT AMDIAL REPLIES in any 
  1414.      Fkey  you  wish  and AMDial will load the dialing  queue  and  proceed 
  1415.      automatically.
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.                                 COMMON PROBLEMS
  1423.      
  1424.      
  1425.      Question - I set up AMDial correctly to dial at a specific time but it 
  1426.      doesn't seem to work.  AMDial never dials.
  1427.      
  1428.      Answer  -  Be  sure that the syntax of the time  you  gave  to  AMDial 
  1429.      matches  the syntax of the Time Mask you have set in Qinstall.   These 
  1430.      must  be  exact!  You must also have the Time Mask in  Qmodem  set  as 
  1431.      hh:mm:ss.    AMDial  requires that the time be in 24  hour  format  in 
  1432.      order to work properly.
  1433.      
  1434.      
  1435.      Question - I'm connected with a PCBoard.  I am able to view  bulletins 
  1436.      while  working  directly with the board I'm calling but  when  I  tell 
  1437.      AutoMate  to  download the bulletins with the GetBulletins  command  I 
  1438.      keep getting a "not found on disk!" error.  Why is this?
  1439.      
  1440.      Answer  - In order for the GetBulletins command to work  properly  the 
  1441.      SysOp  of  the  board you're calling must have the  bulletins  in  his 
  1442.      download  path.   This is usually the \PCB\GEN directory.   Talk  with 
  1443.      your SysOp and have him place the bulletins directory in his  download 
  1444.      path.
  1445.      
  1446.      Question  -  I  was  already online  and  tried  to  start  (re-start) 
  1447.      AutoMate.   It  worked fine in the last version.  Why didn't  it  work 
  1448.      now.  This is the error I got...
  1449.      
  1450.      +========================== Script Error! ==========================+
  1451.      |Type : STRING length 0                                             |
  1452.      |File : C:\QMODEM\SCRIPTS\AUTOMATE.SCR                              |
  1453.      |Line : WaitFor ""                                                  |
  1454.      |Press any key to Edit file                                         |
  1455.      |                                                                   |
  1456.      |                                                                   |
  1457.      +===================================================================+
  1458.      
  1459.      Answer - AutoMate 1.2 detects the current connections type  (software) 
  1460.      at  the time of LogOn(G).  It you are already online you must use  the 
  1461.      SetType command before any other commands in the note file.  This will 
  1462.      tell AutoMate to determine the type of BBS software being used.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.                                HOW TO OBTAIN HELP
  1470.      
  1471.      
  1472.      Support   for  AutoMate  can  be  obtained  by  calling   Absolut(e)ly 
  1473.      Temporary,  the  home  of AutoMate, directly  at  (702) 254-8601,  and 
  1474.      leaving a message in the AutoMate conference.
  1475.      
  1476.      You can also contact us through the echo support conferences.  Post  a 
  1477.      message  addressed to "AUTOMATE SUPPORT" in the AutoMate support  echo 
  1478.      on either the U'NI-Net or RIME message networks.
  1479.      
  1480.      If you have registered your copy of AutoMate, as you should have,  you 
  1481.      can  reach  the author's voice support line by calling  the  telephone 
  1482.      number provided to you in your registration packet.
  1483.      
  1484.      By  supporting  AutoMate  through the Shareware  concept  you  can  be 
  1485.      assured of future updates.  As new mail doors are written and used, we 
  1486.      will be updating AutoMate to work with these doors.
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.                                     CREDITS
  1494.      
  1495.      
  1496.      Thanks to the beta testers...
  1497.      
  1498.      Dane Beko, Larry Boyers, Richard Hanspire, and Charles Shapiro.
  1499.      
  1500.      It  was  through  their time, energy and  persistence,  that  AutoMate 
  1501.      functions as well as it does.
  1502.      
  1503.      A  special thanks goes to Charles Shapiro, of  Absolut(e)ly Temporary, 
  1504.      for his assistance in the development of AutoMate, and the addition of 
  1505.      an AutoMate conference to support its users.
  1506.      
  1507.      The following are official distribution sites for AutoMate.  The  most 
  1508.      recent  version is always available for download.  Additionally,  each 
  1509.      carries the AutoMate support conference.
  1510.      
  1511.      Absolut(e)ly Temporary        (702) 254-8601      U'NI-Net
  1512.      Las Vegas, NV
  1513.      
  1514.      B.A.B.B.L.E.                  (407) 381-2257      RIME
  1515.      Orlando, FL
  1516.      
  1517.      The Ledge                     (818) 352-3620      U'NI-Net
  1518.      Sunland, CA
  1519.      
  1520.      Lunacy                        (805) 251-7052      RIME
  1521.      Santa Clarita, CA             
  1522.      
  1523.      Poverty Rock                  (206) 367-2596      U'NI-Net
  1524.      Seattle, WA 
  1525.      
  1526.      AutoMate is a trademark of Marc Hedish
  1527.      DjMail is a trademark of Derrick Burgess
  1528.      GAP is a trademark of The GAP Development Company
  1529.      Kmail is a trademark of Ken Krueger
  1530.      MarkMail is a trademark of Mark Turner
  1531.      MegaMail is a trademark of Kip Compton
  1532.      PCBoard is a trademark of Clark Development Company, Inc.
  1533.      ProDoor is a trademark of Sam Smith
  1534.      QEdit is a trademark of Semware, Inc.
  1535.      Qmail is a trademark of Sparkware, Inc.
  1536.      Qmodem is a trademark of The Forbin Project, Inc.
  1537.      SFMail is a trademark of Bob Zimmerman
  1538.      SLMR is a trademark of Technique Computer Systems
  1539.      Spitfire is a trademark of Mike Woltz
  1540.      The Complete Mail Door is a trademark of Derek Backus
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.                                SAMPLE NOTE FILES
  1548.      
  1549.      
  1550.      The following samples should help in the development of your own  note 
  1551.      files.
  1552.      
  1553.      
  1554.           AutoMate
  1555.           Larry Boyers  <- Name
  1556.           LISAII.QWK    <- Name of mail packet
  1557.           LISAII.REP    <- Name of Reply packet
  1558.           2             <- Door number of MarkMail (OPEN 2)
  1559.           Z             <- Use Zmodem for mail transfers
  1560.           Logon         <- Logon to the board
  1561.           DeleteMail    <- Delete old mail packet
  1562.           GetMail       <- Get new mail packet
  1563.           Logoff        <- Logoff BBS
  1564.           Term          <- Return to Qmodem terminal mode
  1565.      
  1566.           Example 1
  1567.      
  1568.      
  1569.           AutoMate
  1570.           Larry Boyers
  1571.           AT-MM.QWK
  1572.           AT-MM.REP
  1573.           9
  1574.           Z
  1575.           LogOnG        <- Logs on then immediately returns to terminal
  1576.           Term          <- mode.  Speeds logon.
  1577.      
  1578.           Example 2
  1579.      
  1580.      
  1581.           Automate
  1582.           Larry Boyers
  1583.           AT-MM.QWK
  1584.           AT-MM.REP
  1585.           9
  1586.           Y
  1587.           Logong
  1588.           SendReplies   <- Sends reply packet
  1589.           DeleteReplies <- Deletes reply packet.  No duplicate messages!
  1590.           LogOff
  1591.           Term
  1592.      
  1593.           Example 3
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.      
  1601.      
  1602.      
  1603.           Sysop: Charles Shapiro                 
  1604.           Type:  PCBoard 14.5              This note file contains
  1605.           Nodes: 1                         information about the BBS which
  1606.           Hours: 24 hours a day            not affect AutoMate's operation.
  1607.           Net:   U'NI-Net                  
  1608.           A/T is the home of AutoMate           
  1609.      
  1610.           AutoMate      <- The AutoMate key word
  1611.           Marc Hedish
  1612.           AT-MM.QWK
  1613.           AT-MM.REP
  1614.           9                                      
  1615.           F
  1616.           LogOn
  1617.           ExchangeMail  <- First send replied then get new mail
  1618.           DeleteReplies <- Delete reply packet just sent.
  1619.           SendFiles     <- Automatically sends file from upload directory.
  1620.           AM120.ZIP     <-Filename
  1621.           AutoMate 1.2 - Auto BBSing, Mail runs, file transfers, THE BEST!
  1622.           *             <- * means no more files in list. 
  1623.           GetFiles      <- Download files
  1624.           AT-FILES.ZIP  <- All files list 
  1625.           *             <- End of list marker
  1626.           LogOff
  1627.      
  1628.           Example 4
  1629.      
  1630.      
  1631.           AutoMate      <- Key word tells AutoMate where the commands are
  1632.           Your Name     <- Your name on the board
  1633.           FILENAME.QWK  <- The name of the board's mail packet
  1634.           FILENAME.REP  <- The name of the board's reply packet
  1635.           0             <- The door number of the mail door.
  1636.           G             <- The transfer protocol for the mail door.
  1637.      
  1638.           Example 5
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.      
  1646.      
  1647.      
  1648.           AutoMate
  1649.           Your Name
  1650.           SFMAIL.ZIP    <- Mailpacket for SFMail
  1651.           SFMAIL.REP    <- Reply packet for SFMail
  1652.           M             <- "Door" is "M" from Message Menu
  1653.           Z
  1654.           SetULPath     <-Send reply packet from this directory
  1655.           C:\SFM\
  1656.           SetDLPath     <-Download mail packet to reader's directory
  1657.           C:\SFM\
  1658.           LogOnG
  1659.           DeleteMail
  1660.           ExchangeMail
  1661.           DeleteReplies
  1662.           LogOff
  1663.      
  1664.           Example 6
  1665.      
  1666.      
  1667.           Automate                  This note file shows an example 
  1668.           Store #1232               of a remote location logging into
  1669.           *.QWK                     a Qmodem Host to send daily 
  1670.           *.REP                     accounting information and retrieving
  1671.           1                         any current memos from the main 
  1672.           Z                         office.
  1673.           LogOn
  1674.           SendFiles
  1675.           DAILYRPT.ZIP  <- The Daily Report
  1676.           PAYROLL.ZIP   <- Payroll Information
  1677.           ORDER.ZIP     <- Today's Orders
  1678.           *
  1679.           GetFiles
  1680.           MEMOS.ZIP     <- Get any new memos if they exist
  1681.           *
  1682.           LogOff
  1683.           Quit
  1684.      
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.                                      INDEX
  1692.      
  1693.      
  1694.      .DL, 7                                  GAP, 1, 15, 31
  1695.      .QWK, 7, 12                             GetBulletins, 13
  1696.      .REP, 7, 18                             GetFiles, 14
  1697.      .UL, 7                                  GetMail, 13, 15
  1698.                                              Graphic mode, 16
  1699.      @FSE, 1, 25                             
  1700.      @SCRIPT AMDIAL, 28                      Help, 30
  1701.                                              
  1702.      1K-Xmodem/G                             Installation, 5, 23
  1703.        see Protocols                         
  1704.                                              JoinConference, 15
  1705.      AMDial, 23                              
  1706.      AMDIAL.DAT, 25, 28                      Keywords, 17
  1707.      AUTOMATE.CAP, 11                        KMail, 1, 31
  1708.      Auto-Increment, 5                       
  1709.                                              LogOff, 10, 16
  1710.      BeginRecording, 9, 11                   LogOn, 16
  1711.                                              LogOnG, 16
  1712.      Capture File                            
  1713.        see AUTOMATE.CAP                      Mail packet, 1, 12, 15, 18
  1714.      ChangePassword, 11                      MarkMail, 1, 31
  1715.      Commands, 6, 7, 9                       MegaMail, 1, 31
  1716.      Comments, 8                             
  1717.      Complete Mail Door, The, 1, 31          Password, 11, 14, 16
  1718.                                              PCBoard, 1, 5, 13, 31
  1719.      DeleteMail, 12                          ProDoor, 31
  1720.      DeleteRecording, 12                     Protocols, 7
  1721.      DeleteReplies, 12                       Protocols
  1722.      Dialing queue, 24, 26                     1K-Xmodem/G, 7
  1723.      Directory                                 Ymodem/G, 7
  1724.        Dialing, 1, 6, 14, 16, 21             
  1725.        Download, 12, 15                      QEdit, 25, 31
  1726.        Scripts, 5, 11, 25                    Qmail, 1, 15, 21, 31
  1727.        Upload, 18, 24, 28                    Qmodem, 1, 2, 31
  1728.      DjMail, 1, 31                           Qmodem Host, 11, 13, 15, 16, 18
  1729.      Download, 14, 15                        Queue, 24
  1730.                                              Quit, 10, 16
  1731.      Editor, 1, 25                           
  1732.      End Time, 23, 25                        Registration, 3
  1733.      EndRecording, 12                        Replies, 24, 28
  1734.      EVENT.SYS, 1, 26                        Reply packet, 18, 23, 24
  1735.      ExchangeMail, 13                        RIME, 30
  1736.                                              
  1737.      Fkey, 28                                SendFiles, 17
  1738.                                              SendReplies, 13, 18
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.      SetDLPath, 18
  1746.      SetMailDoor, 19
  1747.      SetType, 9, 19
  1748.      SetULPath, 20
  1749.      SFMail, 1, 31
  1750.      SFMAIL.REP, 7
  1751.      SFMAIL.ZIP, 7
  1752.      Shareware, 3
  1753.      SLMR, 12, 31
  1754.      Spitfire, 1, 31
  1755.      Start Time, 25
  1756.      Status window, 21
  1757.      Support, 30
  1758.      
  1759.      Term, 20
  1760.      Time mask, 23, 29
  1761.      
  1762.      Upload, 18
  1763.      U'NI-Net, 30
  1764.      
  1765.      VOX2HOST, 3
  1766.      
  1767.      Wait until, 26
  1768.      
  1769.      Ymodem/G
  1770.        see Protocols
  1771.  
  1772.  
  1773.  
  1774.